home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 5 / QRZ Ham Radio Callsign Database - Volume 5.iso / files / packet / misc / tfpcx210.exe / KISSINIT.DOC < prev    next >
Encoding:
Text File  |  1993-11-20  |  11.5 KB  |  297 lines
  1.  
  2.  
  3.               KISSINIT Version 1.00  (20. November 1993)
  4.  
  5.                  von René Stange, DG0FT @DB0KG.DEU.EU
  6.  
  7.  
  8.  
  9.  
  10. Inhalt
  11.  
  12.   1. Allgemeines
  13.   2. Programmaufruf und Optionen
  14.   3. Initialisierungsdatei
  15.   4. Anwendungsbeispiel
  16.   5. Urheberrechte und Nutzungsbedingungen
  17.  
  18.  
  19.  
  20. 1. Allgemeines
  21.  
  22.   Bei  vielen TNCs (z.B. PK232, KAM) muß mit speziellen  Befehlen  der
  23.   KISS-Modus  aktiviert  werden,  bevor sie mit  dem  TFPCX  verwendet
  24.   werden  können.  Das TFPCX bietet dafür  selbst  keine  Möglichkeit.
  25.   Das Programm KISSINIT kann beliebige Zeichenfolgen über die serielle
  26.   Schnittstelle  an den TNC ausgeben und damit  die  KISS-Einschaltung
  27.   vornehmen,  wie  auch die Deaktivierung von KISS, wenn der  TNC  für
  28.   andere  Zwecke  benötigt  wird.  Die  Verwendung  von  KISSINIT  ist
  29.   übrigens nicht auf das TFPCX und KISS beschränkt.
  30.  
  31.   Die  Befehle zur Aktivierung des KISS-Modes werden  einer  Textdatei
  32.   (Standard  KISS.INI) entnommen. Sie sind von TNC zu TNC  verschieden
  33.   und sollten in der TNC-Dokumentation angegeben sein. KISSINIT bietet
  34.   die  Möglichkeit, mehrere verschiedene Initialisierungssequenzen  in
  35.   einer  Datei  abzulegen  und  die  benötigte  Variante  beim   Start
  36.   auszuwählen.  Sinnvoll wäre die Schaffung einer Art  Bibliothek  zur
  37.   KISS-Initialisierung  für die gängigen TNC-Typen. Die  mitgelieferte
  38.   Datei  KISS.INI  enthält bereits einige Beispielsequenzen,  die  ich
  39.   verschiedenen  Mailbox-Artikeln entnommen habe, jedoch meist  selbst
  40.   nicht testen konnte.
  41.  
  42.   Wer  bisher mit dem TFPCR gearbeitet hat, kann auch direkt die  dort
  43.   verwendete  Datei  AUTOKISS.CFG übernehmen (in  KISS.INI  umbenennen
  44.   oder  Option  -F verwenden). Falls es dabei Probleme  geben  sollte,
  45.   kann  das  an  der besonderen Bedeutung  einiger  Zeichenfolgen  bei
  46.   KISSINIT liegen, die aber selten in Befehlen auftreten sollten.
  47.  
  48.   Beim  Aufruf von KISSINIT darf das TFPCX nicht geladen  sein,  sonst
  49.   erscheint eine Fehlermeldung. Die KISS-Aktivierung muß vor dem Start
  50.   des  TFPCX erfolgen. Werden mehrere TNCs parallel verwendet, so  ist
  51.   KISSINIT für jeden TNC extra mehrfach aufzurufen.
  52.  
  53.   Die  Parameter  der  seriellen  Schnittstelle  des  TNC  müssen  für
  54.   KISSINIT wie folgt eingestellt sein:
  55.  
  56.   - 8 Datenbits
  57.   - 1 Stopbit
  58.   - kein Paritätsbit
  59.  
  60.  
  61.  
  62. 2. Programmaufruf und Optionen
  63.  
  64.   Beim  Aufruf von KISSINIT können bestimmte Parameter mit  Hilfe  von
  65.   Kommandozeilen-Optionen  beeinflußt werden. Alle  Optionen  beginnen
  66.   mit  einem  '-' und werden durch Leerzeichen  voneinander  getrennt.
  67.   Innerhalb einer Option sind keine Leerzeichen erlaubt.  Groß-/Klein-
  68.   schreibung wird nicht unterschieden. Folgende Optionen sind  möglich
  69.   (mit 'KISSINIT -H' abrufbar):
  70.  
  71.   Options:                                  Default
  72.  
  73.     -PCOMn[:xxx]    COM port [address]      COM1
  74.     -Bnnnn          baud rate               9600
  75.     -Dnnn:nnn:nnnn  delay (char/line/exit)  30:300:2000 (ms)
  76.     -F<file>        init file               KISS.INI
  77.     -S<section>     choose section in file
  78.     -K              kiss reset
  79.     -N              no messages
  80.  
  81.   Die Optionen haben folgende Bedeutung:
  82.  
  83. -PCOMn[:xxx]  Auswahl der seriellen Schnittstelle (n = 1-4)
  84.  
  85.   Hier  ist die Schnittstelle anzugeben, an der der TNC  angeschlossen
  86.   ist   (Standard  COM1).  Die  Portadresse  der  Schnittstelle   wird
  87.   normalerweise  automatisch  ermittelt,  kann aber  bei  Bedarf  auch
  88.   direkt hexadezimal angegeben werden.
  89.  
  90.   Beispiel:
  91.  
  92.   KISSINIT -PCOM3:338
  93.  
  94.   (TNC an COM3 mit Portadresse 338H)
  95.  
  96. -Bnnnn  Baudrate auf der seriellen Schnittstelle (dezimal)
  97.  
  98.   Mögliche  Werte sind 2400, 4800, 9600 (Standard), 19200,  38400  und
  99.   57600 Baud.
  100.  
  101. -Dnnn:nnn:nnnn  Schutzzeiten (dezimal in Millisekunden)
  102.   ^   ^   ^
  103.   1)  2)  3)
  104.  
  105.   Die  meisten TNCs brauchen eine bestimmte Zeit zur Verarbeitung  der
  106.   empfangenen Zeichen, zur Ausführung von Befehlen (am Zeilenende) und
  107.   für  Initialisierungszwecke. Wird darauf keine  Rücksicht  genommen,
  108.   kann  es zu Zeichenverlusten kommen oder der TNC ist noch  nicht  im
  109.   KISS-Modus,  wenn das TFPCX gestartet wird. KISSINIT wartet  deshalb
  110.   nach jeder Zeichenausgabe, am Zeilenende und am Ende der Übertragung
  111.   eine einstellbare Zeit ab, bis die nächste Ausgabe erfolgt bzw.  das
  112.   Programm beendet wird.
  113.  
  114.      Schutzzeiten          Wertebereich  Standard
  115.  
  116.   1) nach jedem Zeichen      0-999  ms     30 ms
  117.   2) nach jeder Zeile        0-999  ms    300 ms
  118.   3) nach der Übertragung    0-9999 ms   2000 ms
  119.  
  120.   Die  Standardwerte für 1) und 2) sollten im Allgemeinen  ausreichen,
  121.   Wert 3) muß aber u.U. vergrößert werden.
  122.  
  123.   Beispiel:
  124.  
  125.   KISSINIT -D30:300:5000
  126.  
  127.   Beim  TNC2 mit The Firmware dauert die  KISS-Initialisierung  einige
  128.   Zeit, speziell bei TNCs mit geringer Taktfrequenz (Blinken der  LEDs
  129.   beobachten). Hier wartet KISSINIT deshalb 5s (= 5000 ms) vor  seiner
  130.   Beendigung,  damit  beim  nachfolgenden Start von  TFPCX  aus  einem
  131.   Batch-File der TNC auch sicher im KISS-Modus ist.
  132.  
  133. -F<Datei>  Name der Initialisierungsdatei (Standard KISS.INI)
  134.  
  135.   Falls  eine andere Datei verwendet werden soll, kann der Name  (auch
  136.   mit Pfad) mit dieser Option angegeben werden.
  137.  
  138. -S<Abschnitt>  Initialisierungssequenz (Abschnitt) auswählen
  139.  
  140.   Die Initialisierungsdatei kann bei Bedarf aus mehrereren Abschnitten
  141.   bestehen, die mit '[Name]' beginnen (siehe unten). Mit dieser Option
  142.   wählt  man  den  Abschnitt aus, der  zur  Initialisierung  verwendet
  143.   werden  soll. Als Parameter wird der Name des Abschnittes  angegeben
  144.   (ohne  []),  wobei Groß-/Kleinschreibung nicht  unterschieden  wird.
  145.   Standardmäßig wird vom Anfang der Initialisierungsdatei gelesen.
  146.  
  147. -K  KISS-Modus ausschalten
  148.  
  149.   Soll der TNC lediglich aus dem KISS-Modus zurückgesetzt werden, wird
  150.   dazu keine Initialisierungsdatei benötigt. Diese Option bewirkt  das
  151.   Senden  der KISS-Reset-Sequenz an den TNC. KISS.INI wird  in  diesem
  152.   Fall nicht gelesen.
  153.  
  154. -N  Meldungen unterdrücken
  155.  
  156.   Hiermit  lassen  sich die Meldungen von KISSINIT und  das  Echo  der
  157.   gesendeten  Zeichen  abschalten.  Fehlermeldungen  erscheinen   aber
  158.   trotzdem.
  159.  
  160.  
  161.  
  162. 3. Initialisierungsdatei
  163.  
  164.   Die Datei kann folgende spezielle Zeichenfolgen enthalten:
  165.  
  166.   \nnn    Steuerzeichen mit dez. ASCII-Code nnn (0-255) ausgeben
  167.   \e      Escape-Zeichen (\27) ausgeben
  168.   \k      KISS-Reset-Sequenz (\192\255\192) senden
  169.   \d      1 Sekunde Pause
  170.   ^c      Control-Zeichen (c = A-Z) ausgeben (z.B. ^X = Ctrl-X)
  171.  
  172.   In den Zeichenfolgen wird Groß-/Kleinschreibung nicht unterschieden.
  173.   Folgt  auf das '\' ein anderes Zeichen als die oben angegebenen,  so
  174.   wird eine eventuelle Sonderbedeutung dieses Zeichens aufgehoben  und
  175.   nur das Zeichen ausgegeben. Soll z.B. das '\' ausgegeben werden, ist
  176.   also '\\' zu verwenden (bzw. '\^' beim Zeichen '^'). Wenn ein '\' am
  177.   Zeilenende  steht, wird das Zeilenende-Zeichen (CR = \13)  nicht  an
  178.   den  TNC ausgegeben. Ein ';' am Zeilenanfang leitet einen  Kommentar
  179.   ein. Die Kommentarzeile wird komplett überlesen.
  180.  
  181.   Die Datei wird standardmässig von Anfang bis Ende verarbeitet.  Wenn
  182.   man  mehrere verschiedene Initialisierungssequenzen speichern  will,
  183.   kann man die Datei aber auch in Abschnitte einteilen, wobei mit  der
  184.   Option -S (siehe oben) ausgewählt wird, welcher Abschnitt  verwendet
  185.   werden  soll.  Ein Abschnitt beginnt mit dem Kopf '[Name]',  der  am
  186.   Zeilenanfang stehen muß. 'Name' ist die Bezeichnung, die der  Option
  187.   -S zu übergeben ist.
  188.  
  189.   Wird die Option -S verwendet, beginnt die Ausgabe in der Zeile,  die
  190.   auf  den  Kopf des gewählten Abschnittes folgt. Hinter  ']'  in  der
  191.   Kopfzeile kann auch ein beliebiger Kommentar stehen. Unabhängig  von
  192.   -S  wird  die Verarbeitung immer beendet, wenn das  Zeichen  '['  am
  193.   Zeilenanfang auftritt, also der nächste Abschnitt beginnt, oder  das
  194.   Dateiende erreicht wird.
  195.  
  196.  
  197.  
  198. 4. Anwendungsbeispiel
  199.  
  200.   Ein  TNC2 mit The Firmware (von NORD><LINK) soll in  den  KISS-Modus
  201.   geschaltet  werden.  Der entsprechende Befehl lautet '@K'  und  wird
  202.   durch ein Escape-Zeichen eingeleitet. Vor der Befehlsausgabe  sollen
  203.   mit  Control-X eventuell im Zeilenpuffer des TNCs  stehende  Zeichen
  204.   gelöscht werden. Die Datei KISS.INI enthält folgende Zeile:
  205.  
  206.   ^X\e@K
  207.  
  208.   Wenn der TNC an COM1 mit 9600 Baud angeschlossen ist, wird  KISSINIT
  209.   z.B. wie folgt gestartet:
  210.  
  211.   KISSINIT -PCOM1 -B9600 -D::5000
  212.  
  213.   Durch  die  Option -D wartet KISSINIT vor dem  Programmende  noch  5
  214.   Sekunden,  damit der TNC die Initialisierung durchführen  kann  (nur
  215.   bei  langsamen TNCs nötig). Die Schutzzeiten für Zeichenausgabe  und
  216.   neue  Zeile  sind hier nicht angegeben (die ':' müssen  aber  sein),
  217.   dafür  werden  die Standardwerte verwendet. Die Optionen -P  und  -B
  218.   könnten  hier  allerdings  auch entfallen, da  COM1  und  9600  Baud
  219.   ebenfalls  Standard  sind. Die Bildschirmausgabe  sieht  bei  diesem
  220.   Beispiel so aus:
  221.  
  222.   ┌───────────────────────────────────────┐
  223.   │ KISSINIT v1.00 (Nov 20 1993) by DG0FT │
  224.   │     Free for non-commercial usage     │
  225.   ├───────────────────────────────────────┤
  226.   │ COM1 (3F8),  9600 Bd,  30 300 5000 ms │
  227.   └───────────────────────────────────────┘
  228.  
  229.   Reading ...
  230.  
  231.   \24\27@K
  232.  
  233.   Im  unteren Kasten wird die serielle Schnittstelle mit  Portadresse,
  234.   die Baudrate und die Schutzzeiten (Zeichen, Zeile, Ende)  angezeigt.
  235.   KISSINIT  gibt  außerdem alle Zeichen aus, die an den  TNC  gesendet
  236.   werden (Echo). Nicht darstellbare Zeichen erscheinen als '\nnn' (nnn
  237.   ist der ASCII-Code). Im Beispiel steht '\24' für '^X' und '\27'  für
  238.   '\e'. Man könnte auch diese Darstellung im File KISS.INI verwenden.
  239.  
  240.   Zur Abschaltung des KISS-Modes und zur nachfolgenden Einstellung des
  241.   Rufzeichens im TNC kann z.B. folgender Dateiinhalt verwendet werden:
  242.  
  243.   \k\d\d\d\d\d\
  244.   \eI CALL
  245.  
  246.   Zunächst erfolgt ein KISS-Reset (\k), nach dem 5 Sekunden (5 mal \d)
  247.   gewartet wird. Diese Zeit benötigt der TNC zum Neustart. Das '\'  am
  248.   Zeilenende bewirkt, daß der nachfolgende Zeilenvorschub nicht an den
  249.   TNC ausgegeben wird. In der folgenden Zeile wird mit dem Befehl  'I'
  250.   das eigene Rufzeichen eingestellt.
  251.  
  252.   Beide  Initialisierungssequenzen  kann man nun wie  folgt  in  einer
  253.   Datei kombinieren:
  254.  
  255.   ;
  256.   ; KISS einschalten
  257.   ;
  258.   [KISSON]
  259.   ^X\e@K
  260.   ;
  261.   ; KISS abschalten
  262.   ;
  263.   [KISSOFF]
  264.   \k\d\d\d\d\d\
  265.   \eI CALL
  266.  
  267.   Der Aufruf von KISSINIT erfolgt dann mit (hier ohne -P und -B):
  268.  
  269.   KISSINIT -SKISSON
  270.  
  271.   bzw.
  272.  
  273.   KISSINIT -SKISSOFF
  274.  
  275.   Die  Datei enthält außerdem noch Kommentarzeilen. Zu  beachten  ist,
  276.   daß diese Datei nicht mehr ohne die Option -S verwendet werden kann,
  277.   weil dabei ab Dateianfang bis zur Zeile '[KISSON]' gelesen wird  und
  278.   hier  nur  Kommentare stehen. Man könnte aber  vor  '[KISSON]'  eine
  279.   'Standard'-Sequenz einfügen, die ohne -S verwendet wird.
  280.  
  281.  
  282.  
  283. 5. Urheberrechte und Nutzungsbedingungen
  284.  
  285.   Der  Autor des Programms KISSINIT ist René Stange (DG0FT).  KISSINIT
  286.   darf zur Verwendung im Amateurfunk als Kopie an Dritte weitergegeben
  287.   werden,  soweit keine Gebühren erhoben werden. Insbesondere ist  die
  288.   Beigabe von KISSINIT zu anderer Hard- und Software nur dann erlaubt,
  289.   wenn  für das jeweilige Produkt ebenfalls keine  Gebühren  berechnet
  290.   werden  oder mein Einverständnis vorliegt. Es ist  nicht  gestattet,
  291.   das Programm kommerziell zu nutzen oder zu vertreiben.
  292.  
  293.   Eine  Garantie für eine ordnungsgemäße Funktion wird nicht  gegeben.
  294.   Der  Autor  kann nicht für eventuelle Schäden, die  durch  die  Ver-
  295.   wendung  von KISSINIT entstehen, haftbar gemacht  werden  (Haftungs-
  296.   ausschluß).
  297.